v1
latestOpenAPI 3.1.02026-07-2359362475.0 KBToken God Mode
Get "Token God Mode" (TGM) perp trades data
Retrieve perpetual trade data for a specific token on Hyperliquid. Shows individual trades with detailed information including trader address, trade side (Long/Short), action type (Add/Reduce/Open/Close), order type (Market/Limit), and trade metrics.
Key Features:
- Hyperliquid perpetual contracts only
- Smart money filtering capabilities
- Detailed trade breakdown with parsed action fields
- Support for both Long and Short position trading
- Market and Limit order types
Request Parameters:
- token_symbol: Token symbol to fetch trades for (e.g., "BTC", "ETH")
- date: Date range for the trades
- filters: Additional filters for side, action, order_type, etc.
- pagination: Page and per_page parameters
post/api/v1/tgm/perp-trades
Request body
Response
TGM perp trades data